home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Grab Bag
/
Shareware Grab Bag.iso
/
001
/
partners.arc
/
PARTNERS.DOC
< prev
next >
Wrap
Text File
|
1987-02-08
|
33KB
|
924 lines
EQUAL PARTNERS
Virtual disk system
Version 1.00
K.eeping I.nformation S.haring S.imple
"If you know DOS then you already know how to use Equal Partners."
COPYRIGHT (c) 1985, 1986, 1987 by Downlink Systems Inc.
ALL RIGHTS RESERVED
This document describes the EQUAL PARTNERS virtual disk system,
version 1.00, which was created by Downlink Sys. in December of 1986.
INTRODUCTION
EQUAL PARTNERS is the copyrighted property of Downlink Sys. Inc.
You are granted a limited license to use , and to copy it and
distribute it, provided that the following conditions are met:
1) No fee may be charged for such copying and distribution.
2) EQUAL PARTNERS may ONLY be distributed in its original, unmodified
state.
Contributions for the use of this program will be appreciated, and
should be sent to:
Downlink Systems Inc.
c/o D. Conner
1377 K. STREET N.W.
SUITE 189
WASHINGTON D.C.
20005
You may not use this product in a commercial environment or a
governmental organization without paying a license fee of $40.
Site licenses and commercial distribution licenses are available.
A program disk and printed documentation are available for $40.
See the order form in the back of this manual for more details.
EQUAL PARTNERS is user supported software. This means that you may
copy the shareware version freely and give the copies away to anyone
you wish, at no cost. They in turn are requested to send in a contri-
bution if they decide to use it.
The user supported software concept (often referred to as shareware)
is an attempt to provide software at low cost. The cost of offering a
new product by conventional means is staggering, and hence dissuades
many independent authors and small companies from developing and
promoting their ideas. User supported software is an attempt to
develop a new marketing channel, where products can be introduced at
low cost.
If user supported software works, then everyone will benefit. The
user will benefit by receiving quality products at low cost, and by
being able to "test drive" software thoroughly before purchasing it.
The author benefits by being able to enter the commercial software
arena without first needing large sources of venture capital.
But it can only work with your support. We're not just talking about
EP here, but about all user supported software. If you obtain a user
supported program from a friend or colleague, and are still using it
after a couple of weeks, then it is obviously worth something to you,
and a contribution should be sent. Upon receipt of a contribution,
you become a registered user and will receive a "full" feature, serial-
ized version of EQUAL PARTNERS.
I. WHAT IS EQUAL PARTNERS.
Equal Partners is a software solution to the problem of sharing data
between 5 1/4 floppy based PC's and the new emerging convertibles
and lap-tops that use the 3 1/2 floppy drives and diskettes or
between different PC's with dissimiliar disk(ette) storage media.
Equal Partners addresses this problem by using inexpensive RS-232
serial adapters , software device drivers and communication programs
to attach the physical drives of one PC to the DOS operating system
of another PC. These physical drives become an extension of and to
the operating system of the other PC so that all DOS functions that
use a drive letter,to access data, function without concern that
these 'virtual' drives are not truly physically attached to the
floppy/hard disk controller cards.
II. WHY USE EQUAL PARTNERS
Equal Partners provides a cost effective solution,as opposed to the
solution that IBM provides. IBM's solution is hardware based and
requires an additional out-of-pocket expense in the neighborhood
of $500.00. Equal Partners allows you to try its low cost solution
for a reasonable time. Then if you realize the cost savings, to
compensate the authors for their efforts and for your peace of mind.
We are sure you would rather use the $500.00 you saved, to invest,
expand and/or enrich your life in other ways.
III. HOW DO YOU ACQUIRE USAGE RIGHTS TO EQUAL PARTNERS.
Equal Partners is not totally free, a small contribution is asked
to allow the authors to feel that their efforts did not fall on
unfertile ground.
The contribution can consist of several forms:
FOR INDIVIDUALS
----------------
1. Monetary
--------
A registration and usage fee of $40.00 is asked, of
individuals. This will provide you with notices of
upgrades and fixes, as well as allow you access to
a version supporting additional com ports and faster
transfer speeds plus other additional features.
2). Personal
--------
Another alternative , if money is a major negative
factor, is that we deeply request that you give a part of
yourself. Instead of a pound of flesh, a donation to your
local Red Cross of 1 pint of blood so that another may
'profit' from your 'gain'/'loss'. This is the least
contribution asked and expected.
FOR COMPANYS
------------
1) Monetary
--------
For businesses, that benefit from additional utility
and time/cost savings, a per copy or site-license is
available and required. Otherwise, no usage license is
granted, and any use is strictly prohibited.
V. HOW DO YOU USE EQUAL PARTNERS
First read the section on REQUIREMENTS, to see if your machine
and its hardware configuration can meet the necessary requirements.
Secondly, install Equal Partners (see INSTALLATION section). Now the
easy part begins.
You say, "nothing is ever easy". We say , "if you know DOS then you
know how to use Equal Partners".
Granted you may not, yet, be a "POWER USER", but we bet you know how
to see whats on your disks, does the "DIR" command ring a bell. Now that
you know whats there, we also bet you got it there with the DOS "COPY"
command or someone did. Starting to catch on yet, we havent tried to
teach you any new convoluted commands with unfamiliar structure and
syntax , have we. Guess what!!. You have just graduated from the ACME
self study and enlightment course that certifies you as a "POWER USER"
of Equal Partners. Take a break, you deserve it. Oh, come back later
to get your EPPU 'certificate of achivement'.
Back so soon?.
Now to the serious business side of matters. You have all this data
, in some form or another, and you need to :
consolidate/manipulate/share/archive/transport
it between/among/with/to another/same media on another PC.
Being a Equal Partners "POWER USER" (EPPU), you know that all you
have to do is use the DOS "COPY" command. So, do it, and give yourself
a pat on the back for a job well done.
We could go on with how to use the other DOS commands, but we are
sure you are ahead of us already. What more can we say, in 25 words
or less, that would not confuse you. Again let us stress, if you
need to access data on the 'server' PC, just use the DOS commands
and the disk drive letters of the 'virtual drives' that are now
logically attached to your PC.
Also, we are sure that you have guessed by now, that if you can
tell DOS where to get the data you need, for a program it shoulde
be just as easy. Sure is, just 'tell' the program that the data it
needs is on one of the 'virtual drives' and business should
continue as always (unless that 'break-even' analysis formula
in the spreadsheet is in error).
REQUIREMENTS
------------
The hardware requirements are:
1). Your machine must be an IBM PC/XT/AT or highly compatible,
including laptops and convertibles.
2). The machine uses an 8250 uart,or compatible, to handle
the RS232C communications.
3). The RS232C cable must have pins 2 and 3 crossed or
a straight thru cable with a null modem.
4). The machine uses the port addresses at memory location
0:400. The port addresses are 03F8 for COM1, and 02F8
for COM2.
5). The disk media must be Dos formatted, in other words
the boot sector must contain the BPB info that describes
-------------------------
the media (the media type in the FAT is not used). Some
vendors that format their own disks do not bother to put
the BPB info in logical sector 0, even thought the Dos 3.2
Technical Ref. manual says that Dos will no longer rely
on the Media code in the FAT to determine the device
characteristics.
6). As always, sufficient memory must be available.
The software requirements are:
1). The operating system must be Dos 2.0 or above.
This product has been tested on PC Dos 3.0, 3.1, 3.2
and 3.21. Note that Dos 3.21 does NOT allow some
Dos commands to be executed. The commands CHKDSK and
several others (for 3.21 only) return a message such
as "CHKDSK not allowed on NETWORK drive".
INSTALLATION
------------
Equal Partners consists of the following files:
50-50.SYS - device driver
EQUAL.COM - communication program
PARTNERS.COM - communication program
PARTNERS.DOC - this documentation
SERVER.BAT - example batch file, with ERRORLEVEL checking
REMOTE.BAT - example batch file, with ERRORLEVEL checking
????????.??? - any additional files as the product matures
Installation assumes two PC's, and the need to exchange data
between the PC's. One PC will be designated the 'server' PC
and the other PC(s) the 'remote' PC(s).
The PARTNERS.COM program may be loaded on and is normally run
from the 'server' PC. The 'server' Pc could be considered the 'base'
PC in that it would normally contain all the master database and
spreadsheet programs and files. The 'remote' PC(s) could be lap-tops
that individuals had taken 'on-the-road' with them to gather data,
for updating to the 'server' databases..ect.
So, installation on the 'server' of PARTNERS.COM consists of
--------------
1). Copying PARTNERS.COM to a directory in the DOS path,
and typing the command , 'PARTNERS' or including it in
a Dos batch file.
Command format:
PARTNERS [/COMx]
where the parameter in "[]" is optional and indicates the
hardware port to use for communications. Replace the "x"
with "1" or "2" to override the installation default.
Note: the "[]" are NOT part of the command!.
Note: the install results may be tested in a batch
file with the ERRORLEVEL statement.
Now, installation on the 'remote' consists of
--------------
1). Including the following command in 'CONFIG.SYS'
DEVICE=50-50.SYS 'z' additional disk drives requested
(where 'z' can be any number from 1 to 8, default=1)
2). Copying EQUAL.COM to a directory in the DOS path
and typing the command, 'EQUAL' or including it in
a Dos batch file.
Command format:
EQUAL [/COMx]
where the parameter in "[]" is optional and indicates the
hardware port to use for communications. Replace the "x"
with "1" or "2" to override the installation default.
Note: the "[]" are NOT part of the command!.
Note: the install results may be tested in a batch
file with the ERRORLEVEL statement.
Once installed , any DOS command that would normally access data
using a drive designation, will be able to read/write data from
one PC to the other PC(s). What this means is that you can 'COPY',
, 'ERASE', 'RENAME', 'PATH', and execute programs to/on/from
the 'virtual' drives without any new commands or procedures.
If you know DOS then you already know how to use Equal Partners.
RAMDISK SUPPORT
If you have a RAMdisk, or other high-speed storage, then you can speed
up EP somewhat by telling DOS to read from/write to the RAMdisk.
You do this by substituting the drive letter of the RAMdisk in all
the MS-DOS commands. For example, if drive H: is your virtual RAMdisk,
then you would type:
COPY H:*.* D:
(where D: could be a RAMdisk on your 'remote' PC)
Refer to the MS-DOS manual for more details about the DOS commands.
PROGRAM EXECUTION RESTRICTIONS
If are using a Shareware version on EQUAL PARTNERS, and have not
registered, then the following program executions restrictions
apply:
1). Only 9,600 baud transfer rate is available.
2). Only Com1 is supported.
3). Only one virtual drive may be specified in
config.sys.
4). Only reading is allowed, in otherwords you
may only copy data "from" the server. You
are not allowed to perform any Dos function
that would "write" to the server.
5). The starting drive on the server is always the
"A:" drive. This means that the first virtual
drive assigned on the "remote" is the first
physical drive accessed on the "server".
6). All read/write timing limits are based on a PC
running at 4.77 mhz. Faster cpu's may/will cause
consistant read/write errors. Also some storage
devices, such as a Bernoulli box, may cause timing
problems due to the fact that it may require several
seconds for the Bernoulli box to come up to speed.
DISK DRIVE MAPPING
This simple illustration shows how the drives and the letters
assigned are mapped to the physical vs. virtual drives.
'REMOTE' 'SERVER'
+---------------+ +---------------+
| +---------+ o| | +---------+ o|
| |A:>dir C:| o| | | Partners| o|
| | | | | | v1.0 | |
| |Volume in| | | |Copyright| |
| +---------+ | | +---------+ |
+---------------+ +---------------+
+------------------------+ +------------------------+
| IBM o o | Rs232 ---- cable | IBM + o |
| PC --=-- --=-- | ---------| |---------| PC --=-- --=-- |
| |<-- ---- | |
+------------------------+ | +------------------------+
^ ^ | ^ ^ ^
| | | | | |
| | | | | |
Physical Physical | Null Physical Physical
Drive A: Drive B: | Modem Drive A: Drive B:
|
| ^ ^
| | |
| | |
|
-------------------------> Virtual Virtual
Drive C: Drive D:
There may be Ramdisks on either or both the 'SERVER' and 'REMOTE'
PCs. Ramdisks are highly recommended, memory permitting, because this
eliminates all the mechanical delays that real hardware drives exhibit,
such as rotational delay, seek times and drive startup..ect.
PROGRAM UPDATE SERVICE
A license to EP entitles you to use all future Shareware versions. New
"restricted usage" versions are generally available through normal
freeware distribution channels, and we prefer that you obtain them that
way.
A Program disk containing the latest version is returned on every
order of $40 or more. If you wish to purchase a single-user license
and want an update disk, please enclose a check or money order for $40.
For a fee of $50 per year you can subscribe to our program update
service. Subscribers get up to five program updates per year mailed
to them as new versions come out. This does not include trivial
releases.
VERSION NUMBERS
All of our version numbers are given as a number with two decimal
places.
The units indicate a major revision, such as adding a new feature, maybe
such as virtual printer support.
The first decimal place (tenths) indicates a minor revision that is
not essential, but which may be desired.
The second decimal place (hundredths) indicates a trivial revision
that will probably only be desired by specific individuals or by die-
hard "latest version" fanatics.
To sum up: If the units change, then you should get the newer version
as soon as you can. If the tenths change, then you may want to get
the newer version, but there's no hurry. If anything else changes,
then you probably shouldn't bother.
TECHNICAL REQUIREMENTS AND NOTES
--------------------------------
Equal Partners uses the RS-232C hardware to interface the PC's and
provide the 'bridge' to allow the exchange of data.
The hardware consists of the standard 8250 uarts and the DB-25
or DB-9 connectors and cables. However , only pins 2, 3, and 20,
are used. Also pins 2 and 3 are required to be crossed-over,
or you can build or purchase a modem eliminator/null modem.
(See your local electronics parts dealer: such as RADIO SHACK)
This is the basic diagram of the CROSS-OVER pin configuration
'SERVER' 'REMOTE'
------ ------
| | | |
| 2 |--------------\ /|2 | Pins
| | / | |
| 3 |--------------/ \|3 |
| | | |
| 20 | ----------------|20 |
------ ------
DB-25 DB-25
The following are notes and considerations both technical
and otherwise:
1). Both EQUAL.COM and PARTNERS.COM use COM1 or
COM2 as the 'bridge'. The port addresses are
disabled so that Basic will not interfere, as
Basic tries to take over the com ports when
loaded, even if does not need them. Com1 is
only available for the shareware version.
The program , 'PARTNERS.COM' will revector
and restore the com ports addresses when it
is de-actived however.
2). The program ,'EQUAL.COM', installs resident and
attaches itself to DOS, so that once installed its
there to stay.
3). The data transfer rate is 9,600 baud for the shareware
version. Registered users may select rates up to 110,000
baud.
4). Error checking is performed on each block of
data. Crc-16 is used to insure the integrity of
your financial data and programs.
5). Ramdisks with sector sizes between 128 and 512
bytes are supported This applies to other disk
media as well. The sector sizes must be a power
of 2.
Appendix A - Program Messages.
All message text is preceeded by a formatted message code.
The format of the message code is:
EPxNNNy
where :
x= 'D' - for 50-50.SYS program output messages
'E' - for EQUALS.COM program output messages
'P' - for PARTNERS.COM program output messages
and
NNN= 000 thru 999, which is the message number for this
message type.
and
y= 'D' - for Dignostic type messages. These messages are
normally printed only if a critical error occurs
or the program is in a 'test' or debugging mode.
'E' - for Error messages. These type messages indicate
that an unrecoverable error occured and the program
could not take any corrective action, except to
attempt to return to the DOS prompt.
'I' - for Informative messages. These messages are just
to inform you as to the processing state of the
program at any given time.
'W' - for Warning messages. These messages indicate
that an error occured, but that the program
was able to take corrective action and continue
processing. However, the function the program was
attempting may or may not have been successfully
completed.
Message Code Message text and its explanation
------------ ----------------------------------------------------
EPD001I - EQUAL PARTNERS Virtual disk driver V1.0
(C)Copyright DOWNLINK SYS. INC. 1986
This is the copyright message displayed from the
virtual disk device driver during PC power-up.
EPD002I - 1 virtual disk drive(s) available to DOS
This message indicates the number of additional
disk drives ('virtual') that DOS can access. These
drives may be accessed by the DOS commands or any
program by using the drive letters assigned, by DOS,
to the virtual disks. Registered users may access up
to 8 virtual disks, the shareware version allows
access to only 1 virtual disk.
EPE001E - installation cancelled - COM channel undefined
The program was trying to install, but was unable
to find a communications port address at the desired
memory location. The only recourse is to return to
DOS.
EPE002E - installation cancelled - 50-50 driver not installed
The device driver, 50-50.sys, was not included in the
DOS file 'config.sys'. If your intent is to run this
PC as a 'remote', then see the INSTALLATION section
for the correct program configurations.
EPE003E - installation cancelled - ALREADY installed
The program EQUAL.COM has already been installed once.
Multiple installations are not allowed.
EPE000I - EQUAL activated - Communications link is COMx
This message relects that the installation of EQUAL is
in progess and that the Communications port, COMx, was
the port selected to link the "remote" to the "server"
EPE001I - EQUAL installed - Virtual drives C: thru C: available for use
This is the most important type 'I' message that is
displayed. This message reflects the additional 'drive'
letters you use on all DOS commands and in programs, to
access data on the 'server' PC.
The drive letters displayed depends on the number of
virtual drives requested (up to 8 allowed) on the
'device=50-50.sys' statement in the DOS 'config.sys' file.
EPE999I - EQUAL shutdown - returning to DOS
This message indicates that EQUAL.COM is returning to
DOS. See any additional messages for the exact reason.
Message Code Message text and its explanation
------------ ----------------------------------------------------
EPP001E - installation cancelled - COM channel undefined
The program was trying to install, but was unable
to find a communications port address at the desired
memory location. The only recourse is to return to
DOS.
EPP002E - installation cancelled - EQUAL is already installed
The program is trying to be installed on a machine
that already has the EQUAL.COM program installed.
You can't make one machine both a 'remote' and a
'server'.
EPP000I - PARTNERS activated - Communications link is COMx
This message relects that the installation of PARTNERS
is in progess and that the Communications port, COMx,
was the port selected to link the "server" to the "remote".
EPP001I - PARTNERS installed -waiting for remote responce
You have entered PARTNERS from the Dos prompt or in
a batch file. PARTNERS is now installed (not resident)
and is waiting for RS-232 input on the communications port.
The programs EQUAL.COM and 50-50.SYS have to be installed
on the "remote" computer to complete the "bridge",so
that data may be freely transfered between computers.
EPP999I - PARTNERS shutdown - returning to DOS
You have either pressed the 'ESC' key or installation
failed.
EPP001W - Invalid I/O request - flushing input buffer
Extraneous or corrupted information was received. The
programs only recourse is to ignore the data, flush
all buffers and try to get in sync with the other PC.
EPP001D - AX= BX= CX= DX=
This message display the internal register states.
The message is normally display only when a critical
error occurs or the programs debugging mode is active.
EPP002D - -
This message is preceeded by message code EPP001D.
Several additional message lines will be displayed
indicating the reason for this diagnostic message.
Appendix B - Site License
SITE LICENSE
Corporate users may wish to obtain a site license for the use of EP.
The site license applies only to one geographical area, not to exceed
a 50 mile radius. Additional site licenses are required for each
unique geographical location.
Please use the order form in this manual to order a site license.
Site licenses are granted when we receive your payment. License fees
vary depending on the number of computers on which EP will be used,
as follows:
1 to 9 copies $40 each
10 to 24 copies $35 each
25 to 49 copies $30 each
50 to 99 copies $25 each
over 99 copies $3000 one time fee
The following page is a site license agreement, which should be signed
and sent with your payment when ordering a commercial site license.
The use of EP in a commercial environment or government organization
is granted under the following terms:
1. Payment of the license fee must be made payable to Downlink
representative
D. Conner
The fee is based on the number of computers which will be used
to run EP , as follows:
1 to 9 copies $40 each
10 to 24 copies $35 each
25 to 49 copies $30 each
50 to 99 copies $25 each
over 99 copies $3000 one time fee
2. You may use EP on the number of computers included in the license
fee. If you have paid the fee for over 99 copies, then you may
use EP on any number of computers within your organization, within
a given geographical area.
3. You may make copies of the program and documentation, in their
original, unmodified form. You may distribute these copies, within
the limits of the number of copies licensed.
4. You may make copies of the program documentation, in both its
printed form and machine readable form, without restriction.
5. You may use all future "restricted-usage" Shareware versions of EP
under this license.
The latest version is available from Downlink for a small service
charge.
6. You may NOT modify the program or charge a fee for copying or
distributing the program or its documentation.
7. It is your responsibility to make the necessary copies and to
deliver them to the computers which they will be used on.
8. We are not responsible for anything that may happen or not happen
if you use EP. You're on your own.
I agree to abide by the terms and conditions of this license.
_____________________________ __________________________
Signature Date
_____________________________
Name (please print or type)
_____________________________
Title
_____________________________
Company
Appendix D - Ordering
ORDER FORM
Check which items you wish to purchase:
(_) Noncommercial license for the use of EP.
(_) Commercial license for the use of EP on ___ computers (see
price schedule and terms on preceding page).
(_) Program update subscription service (not more than five
updates, does not include trivial changes), $50/year.
(_) Payment of $_____ is enclosed (check or money order).
Signature: ________________________________
_______________________________________________
Name
_______________________________________________
_______________________________________________
Address
______________________ ________ ____________
City State Zip
Send this completed form to:
Downlink Systems Inc.
c/o D. Conner
1377 K STREET N.W.
SUITE 189
WASHINGTON D.C. 20005
For program disk orders outside the U.S., please add an additional $5,
and enclose an international money order payable in U.S. currency.
For commercial site license orders, please enclose a signed copy of
the site license agreement.
Inquires for Corporate wide unlimited usage licenses are welcome.